home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / bbslist3.zip / BBSLIST.DOC < prev    next >
Text File  |  1991-07-04  |  11KB  |  329 lines
  1.  
  2.  
  3.                    BULLETIN BOARD LISTING DOOR!
  4.                    ----------------------------
  5.  
  6.                          Mike Wilson
  7.  
  8.                       Secret Service BBS
  9.  
  10.                         (304) 429-6838
  11.  
  12.                         1200/2400/9600
  13.  
  14.  
  15.  
  16. FEATURES
  17. ---------
  18. This door will run directly on Wildcat, PCBoard, Gap, QBBS or Spitfire.
  19. It will lock at 38400 + Baud rates and will support Non-standard IRQ's
  20. and Port address's on Coms 3 and 4.
  21.  
  22. Purpose of the Door
  23. -------------------
  24. This program will allow users to enter their board name,
  25. sysop name, hours of operation, and a little note about
  26. the purpose of their board. The program writes both Color
  27. and Mono Bulletins, calls them whatever you wish, and places
  28. them wherever you specify in the configuration.
  29.  
  30. Disclaimer
  31. ----------
  32. I will not be held in any way responsible for your use of this door program.
  33. All care has gone into making this a reliable software program but I assume
  34. no liability for its use or any direct or indirect damages.
  35.  
  36. Registration
  37. ------------
  38. If you wish to register this door and have your BBS name put on the opening
  39. screen then send $5 to:
  40.                            Mike Wilson
  41.                            P.O. Box 9521
  42.                            Huntington WV 25704
  43.  
  44. That will cover shipping, handling, and the cost of a diskette.
  45. Read Register.txt for registration form!
  46.  
  47. Installation
  48. ------------
  49. Installation is simple.  Create a new directory and dissolve the
  50. contents of BBSList.zip into it.
  51. Run Setup.exe and answer the questions as they appear. The setup.exe
  52. will create several files for you.
  53. If you have problems answering a question asked in Setup.exe please
  54. read the detailed description of each file below.
  55. Copy the two files Color.SCR and ASCII.BBS into the directory that
  56. you specified in your LST.Cfg setup within setup.exe.
  57. Rename them whatever you want each of the bulletins to be called
  58. (the same file names you specified in LST.CFG).Example: Rename
  59. Color.scr to the file name you want the color bulletin to be
  60. called. Rename ASCII.bbs to whatever you want the mono bulletin
  61. to be called. Make sure they reside in the directory that you
  62. specified in LST.cfg.
  63. Set up a batch file to call the door from your BBS. If you don't know
  64. how to do this please read the BATCH FILES section below.
  65.  
  66. The following are what is each file BBSList uses:
  67.  
  68. LST.CFG
  69. -------
  70. This file is created by Setup.exe.
  71. This file contains just two lines. The first line is the path
  72. and name of the COLOR bulletin that will be written.
  73. The second line is the path and name of the mono bulletin
  74. that will be written.
  75. These can be ANY proper path and DOS filename.
  76.  
  77. EX.
  78. C:\Path\bull99.scr <- path to color bulletin
  79. C:\Path\bull99.bbs <- path to mono bulletin
  80.  
  81. Thats all that is requred in lst.cfg!
  82.  
  83. BBSLIST.CFG
  84. ----------
  85. This is a three line file that contains your board name, the
  86. path to the board info file and whether to lock the com port or
  87. not.
  88.  
  89. EX:
  90.  
  91. Mike Wilson          <--------- Sysop Name
  92. C:\Path\BBSinfo.???  <--------- Path to Board Info file (see below)
  93. NO                   <--------- No or Locked Com Port Baud Rate
  94.  
  95. The line asking for Board Info file refers to the path and name
  96. of the file your particular BBS creates when it drops out to run
  97. a door. This would be:
  98. Wildcat prior to V3.0 -> Callinfo.bbs       PCBoard ----> PCBoard.sys
  99. GAP or WILDCAT 3.0+ ---> Door.sys           Spitfire ---> SFDoors.dat
  100. QuickBBS ---> DorinfoX.def (The X is 1 or 2 depending on Node #)
  101.  
  102. A proper example would be: C:\Wildcat\Callinfo.bbs
  103.  
  104. ** Note for Multi-nodes ***
  105. You only need one LST.CFG but you will need a BBSLIST.CFG for each node!
  106. Create as many .cfg's as you need pointing the way to the correct node
  107. information. Call the game and .cfg as follows from batch files.
  108.  
  109. Example: Node 1
  110.                      Game Game.cfg
  111.  
  112.          Node 2      Game Game1.cfg
  113.  
  114. ** Read Port.doc if you run multi-nodes and need to alter the Com 3 or 4
  115.    address or IRQ's.  It will instruct you on how to do so.
  116.  
  117. You will find two other files in the zip also, they are
  118. called Color.Scr and ASCII.bbs. These are just the headers
  119. for the bulletins that will be created. Copy them into the
  120. directory where you want your bulletin to be placed (as you
  121. specified in the LST.CFG) and rename them to whatever your
  122. bulletin is going to be called. (Ex: If your wanting the
  123. listing to be called bull5.scr then rename Color.scr to
  124. bull5.scr, the same would be true for ASCII.bbs to
  125. bull5.bbs).
  126.  
  127. BOARD.TXT
  128. ---------
  129. Don't worry about this file. It is created when you run setup.exe
  130. This file tells the game which BBS Software you are running and
  131. tells it to read the correct board file. THERE SHOULD NOT BE A
  132. BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
  133. PRIOR TO VERSION 3.0!
  134. The game looks for this file and defaults to Wildcat if it isn't
  135. found.
  136. For other boards it will contain one line with one of the following:
  137. QuickBBS --------> QBBS         GAP or WILDCAT 3.0+ ---> GAP
  138. PCBoard ---------> PCB          Spitfire --------------> SPITFIRE
  139.  
  140.  
  141.  
  142.                                   Batch Files
  143.                                =================
  144.  
  145. Be sure that you have edited or created the BBSLIST.CFG file with the correct
  146. information as described earlier in these docs. The individual setups do not
  147. repeat this necessary process.
  148.  
  149.  
  150.  
  151. Wildcat! 1.13 & 2.0+ Setup:
  152. ---------------------------
  153. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  154.  
  155.    ECHO OFF
  156.    CD \WILDCAT\DOORS\BBSLIST
  157.    BBSLIST BBSLIST.CFG
  158.    CD \WILDCAT
  159.    CAT.BAT
  160.  
  161. place this batch file in your Node# directory if running Multi-Nodes or in
  162. your Wildcat (default) directory if single node.
  163.  
  164. Second, Create a sub-directory for the door program such as in the following
  165. example:
  166.  
  167. C:\WILDCAT\DOORS\BBSLIST
  168.  
  169. Third, put the BBSLIST game files in the \WILDCAT\DOORS\BBSLIST directory.
  170.  
  171. Forth, add this game to your live program menu for user selection and your
  172. ready to run the door.
  173.  
  174. If this is a little unclear then please read your systems documentation for
  175. more detailed instructions.
  176.  
  177. If you use a door monitoring program then read their documentation for
  178. their specific setup.
  179.  
  180.  
  181. Gap Setup:
  182. ----------
  183. First, add the number and name of the door to your menu. This will allow the
  184. user to select the door by number.
  185.  
  186. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  187. directory. Following is an example line to add:
  188.  
  189.    BL 10
  190.  
  191. where 'BL' stands for the name of the batch file (shown below) to invoke the
  192. the door and '10' is the required security level.
  193.  
  194. Third, create a sub-directory for BBSLIST to be placed in. And example
  195. would be:
  196.  
  197. C:\GAP\BBSLIST
  198.  
  199. place all the files in the BBSLIST.ZIP archive inside this directory.
  200.  
  201. Forth, create a batch file called BBSLIST which should be placed in the
  202. default directory. Following is example contents of this file:
  203.  
  204.    ECHO OFF
  205.    CD\GAP\BBSLIST
  206.    BBSLIST BBSLIST.CFG
  207.    CD\GAP
  208.    GAP
  209.  
  210. the last line in the BBSLIST file should invoke the batch file which loads
  211. the GAP BBS system.
  212.  
  213. If this is a little unclear then please read your systems documentation for
  214. more detailed instructions.
  215.  
  216. If you use a door monitoring program then read their documentation for
  217. their specific setup.
  218.  
  219.  
  220.  
  221. Spitfire Setup:
  222. ---------------
  223. First edit your SFDOOR.MNU and add the following line. If you are not running
  224. and doors at this time you will need to create this file.
  225.  
  226.    BBSLIST, 10
  227.  
  228.    Where BBSLIST is the name of the door to appear on your menu and the 10
  229.    is the lowest security level that will be allowed to enter the door. Don't
  230.    forget the comma (,) after the name.
  231.  
  232. Second create a sub-directory to place the door game in. In this example we
  233. will use 'C:\SF\DOOR_A' for the game directory.
  234.  
  235.  
  236. Third move all the files in the BBSLIST.ZIP archive into this directory.
  237.  
  238. Forth edit your SF.BAT file adding the following lines.
  239.  
  240. :DOOR_A
  241.    CD\SF\DOORS_A
  242.    BBSLIST BBSLIST.CFG
  243.    CD\SF
  244.    GOTO LOOP
  245.  
  246. Fifth, rerun Sf.BAT and your ready to begin play.
  247.  
  248. If this is a little unclear then please read your systems documentation for
  249. more detailed instructions.
  250.  
  251. If you use a door monitoring program then read their documentation for
  252. their specific setup.
  253.  
  254.  
  255.  
  256. PCBoard 14.0+ Setup:
  257. --------------------
  258. First, edit your DOORS and DOORSG file so that it shows BBSLIST with the door
  259. number relating to it's position in DOORS.DAT.
  260.  
  261. Second, edit the DOORS.DAT file so that it includes BBSLIST.
  262.  
  263. Third, create a sub-directory for BBSLIST to be placed in. And example
  264. would be:
  265.  
  266. C:\PCB\BBSLIST
  267.  
  268. place all the files in the BBSLIST.ZIP archive inside this directory.
  269.  
  270. Forth, create a batch file called BBSLIST which should be placed in the
  271. default directory. Following is example contents of this file:
  272.  
  273.    ECHO OFF
  274.    CD\PCB\BBSLIST
  275.    BBSLIST BBSLIST.CFG
  276.    CD\PCB
  277.    BOARD
  278.  
  279. the last line in the BBSLIST file should invoke the batch file which loads
  280. the PCboard BBS system.
  281.  
  282. If this is a little unclear then please read your systems documentation for
  283. more detailed instructions.
  284.  
  285. If you use a door monitoring program then read their documentation for
  286. their specific setup.
  287.  
  288.  
  289. QuickBBS Setup:
  290. ---------------
  291. First, add the game to your games menu and select the correct type for doors.
  292.  
  293. Second, create a sub-directory for the game and move all the files from the
  294. zip file to this directory.
  295.  
  296. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  297. Since QuickBBS only supports one node at this time then this file should be
  298. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  299. of the configuration file.
  300.  
  301.    Note: It was told to me that the upcoming 3.0 version of QuickBBS will
  302.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  303.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  304.          where you can specify this new name as well as any others.
  305.  
  306. Forth, create a batch file called BBSLIST which should be placed in the
  307. default directory. Following is example contents of this file:
  308.  
  309.    ECHO OFF
  310.    CD\QUICKBBS\BBSLIST
  311.    BBSLIST BBSLIST.CFG
  312.    CD\QUICKBBS
  313.    QBBS.BAT
  314.  
  315. the last line in the BBSLIST file should invoke the batch file which loads
  316. the QuickBBS system.
  317.  
  318. If this is a little unclear then please read your systems documentation for
  319. more detailed instructions.
  320.  
  321. If you use a door monitoring program then read their documentation for
  322. their specific setup.
  323.  
  324.  
  325.  
  326.  
  327. I hope that you enjoy the utility!!!
  328.  
  329. Please try some of my many other doors and games!